En este artículo se considerará la creación de cuentas y unidades mediante el Remote API. Estos elementos son clave al trabajar con Wialon, y su creación requiere la ejecución de una serie de acciones obligatorias.

También pueden ser útiles:

Creación de una cuenta

Antes de realizar esta acción, es necesario recordar dos términos importantes:

• Creador: es el usuario en nombre del cual se crea un determinado elemento del sistema.
• Cuenta: es un macroobjeto del sistema que representa la unidad de un recurso, un usuario y un plan de facturación.

Por lo tanto, para crear una cuenta, es necesario:

1. Encontrar un plan de facturación adecuado.
2. Encontrar el system ID del usuario creador, bajo el cual se creará el nuevo usuario.
3. Crear un nuevo usuario en nombre del usuario encontrado.
4. Crear un recurso en nombre del nuevo usuario.
5. Unir el nuevo usuario, el recurso y el plan de facturación en una cuenta.

Veamos las solicitudes necesarias en cada uno de estos pasos con el siguiente ejemplo: es necesario crear una cuenta con el nombre sdk_account, que en la jerarquía del servicio estará bajo la cuenta del usuario manager.

1. Búsqueda del plan de facturación

Usamos la solicitud core/get_account_data.

https://hst-api.wialon.com/wialon/ajax.html?svc=core/get_account_data&params={"type":1}&sid=SESSION_IDENTIFIER

Los nombres de los planes de facturación asignados se mostrarán en la respuesta a la solicitud en el parámetro subPlans. Supongamos que usaremos el plan de facturación con el nombre standard_client.

2. Búsqueda del ID del sistema del usuario creador

Usamos la solicitud core/search_items.

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items&params={"spec":{"itemsType":"user","propName":"sys_name","propValueMask":"manager","sortType":"sys_name"},"force":1,"flags":1,"from":0,"to":0}&sid=SESSION_IDENTIFIER

El ID del sistema del usuario se mostrará en la respuesta a la solicitud en el parámetro id. Supongamos que tiene el valor 11111.

3. Creación de un nuevo usuario

Usamos la solicitud core/create_user.

https://hst-api.wialon.com/wialon/ajax.html?svc=core/create_user&params={"creatorId":11111,"name":"sdk_account","password":"Pa%24%24w0rd","dataFlags":1}&sid=SESSION_IDENTIFIER

El ID del sistema del usuario se mostrará en la respuesta a la solicitud en el parámetro id. Supongamos que tiene el valor 22222.

4. Creación de un recurso

Usamos la solicitud core/create_resource.

https://hst-api.wialon.com/wialon/ajax.html?svc=core/create_resource&params={"creatorId":22222,"name":"sdk_account","dataFlags":1,"skipCreatorCheck":0}&sid=SESSION_IDENTIFIER

El ID del sistema del recurso se mostrará en la respuesta a la solicitud en el parámetro id. Supongamos que tiene el valor 33333.

5. Unión en una cuenta

Usamos la solicitud account/create_account.

https://hst-api.wialon.com/wialon/ajax.html?svc=account/create_account&params={"itemId":33333,"plan":"standard_client"}&sid=SESSION_IDENTIFIER

Creación de una unidad

Para crear una unidad mediante el Remote API, es necesario:

1. Encontrar el ID del sistema del tipo de equipo.
2. Encontrar el ID del sistema del usuario creador, en cuya cuenta se ubicará la futura unidad.
3. Crear la unidad.
4. Asignar un ID único a la unidad.

Veamos las solicitudes necesarias con el siguiente ejemplo: es necesario crear una unidad Delivery truck con el tipo de equipo Wialon IPS y el ID único 12345 en la cuenta del usuario sdk_account.

1. Búsqueda del ID del sistema del tipo de equipo

Usamos la solicitud core/get_hw_types.

https://hst-api.wialon.com/wialon/ajax.html?svc=core/get_hw_types&params={"filterType":"name","filterValue":["Wialon%20IPS"],"includeType":0,"ignoreRename":1}&sid=SESSION_IDENTIFIER

El ID del sistema del tipo de equipo se mostrará en la respuesta a la solicitud en el parámetro id. Supongamos que tiene el valor 44444.

2. Búsqueda del ID del sistema del usuario creador

Usamos la solicitud core/search_items.

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items&params={"spec":{"itemsType":"user","propName":"sys_name","propValueMask":"sdk_account","sortType":"sys_name"},"force":1,"flags":1,"from":0,"to":0}&sid=SESSION_IDENTIFIER

El ID del sistema del usuario se mostrará en la respuesta a la solicitud en el parámetro id. Supongamos que tiene el valor 22222.

3. Creación de la unidad

Usamos la solicitud core/create_unitcore/create_unit.

https://hst-api.wialon.com/wialon/ajax.html?svc=core/create_unit&params={"creatorId":22222,"name":"Delivery%20truck","hwTypeId":"44444","dataFlags":1}&sid=SESSION_IDENTIFIER

El ID del sistema de la unidad se mostrará en la respuesta a la solicitud en el parámetro id. Supongamos que tiene el valor 55555.

4. Asignación de un ID único

Usamos la solicitud unit/update_device_type.

https://hst-api.wialon.com/wialon/ajax.html?svc=unit/update_device_type&params={"itemId":55555,"deviceTypeId":"44444","uniqueId":"12345"}&sid=SESSION_IDENTIFIER

Ekaterina Grib,Customer Service Engineer 2023-08-20